==========================================================================
  ROSETTA RADAR  —  Read Me First
  Ast-Ware Arts   ·   © 2026 Ast-Ware Arts   ·   Free to use and share
==========================================================================

WHAT IT DOES
------------
Rosetta Radar checks each application's primary program and sorts them:

   • Intel-only ....... 64-bit Intel; needs Rosetta 2 on an Apple Silicon Mac
   • Universal ........ runs natively on both Intel and Apple Silicon
   • Apple Silicon .... runs natively on Apple Silicon Macs
   • 32-bit Intel ..... legacy; modern macOS can no longer run these at all
   • Other ............ scripts, web apps, or helpers with no standard binary

Apple is phasing Rosetta 2 out. Once it is removed in a future macOS
release, any "Intel-only" app will stop opening. This tool gives you a
clear list of those apps so you know what may need updating or replacing.
(Rosetta Radar checks each app's main program; an app could still contain
a separate Intel-only component or plug-in that isn't shown.)

It reads the same information macOS itself shows under:
    Apple menu  >  About This Mac  >  More Info  >  System Report...  >
    Software > Applications  ("Kind" column)


WHAT YOU GET
------------
Each time you run it, your report is saved to your DESKTOP. When it starts,
it asks which files you would like — you can create both, or just one:

   • Rosetta-Radar-Report-<date>.html ... a readable report (opens by itself)
   • Rosetta-Radar-Report-<date>.csv .... the same data as a spreadsheet
                                       (open in Numbers or Excel)

Choose "Both" (the default) for the readable report and the spreadsheet,
"HTML only" for just the report, or "CSV only" for just the spreadsheet.


HOW TO RUN IT
-------------
Double-click  "Rosetta Radar"  (the app with the radar icon).

>>> FIRST TIME ONLY <<<
Because this is a free tool that is not sold through the App Store,
macOS will ask you to confirm before it runs the first time. This is
normal. Do ONE of the following:

   Easiest:
      1. RIGHT-CLICK (or Control-click) the app.
      2. Choose "Open".
      3. In the box that appears, click "Open" again.

   If macOS still refuses ("cannot be opened"):
      1. Open  System Settings > Privacy & Security.
      2. Scroll down. You will see a note about "Rosetta Radar".
      3. Click "Open Anyway", then confirm.

After the first time, it opens with a normal double-click.

When it launches it asks a couple of quick questions — whether to also scan
external / mounted volumes (most people can skip this), and which files to
create (HTML report, CSV spreadsheet, or both) — then shows a progress window
while it works. When it finishes, the report opens in your web browser (if you
chose to create one) and a summary appears.

In the report, each app shows a short description of what it does. The
Source column shows who signed the app (the developer's name when known,
or "Apple", "Mac App Store", or "Unidentified"), and a "Last Opened"
column shows when you last launched it (from Spotlight; blank if never
opened or not indexed). When Rosetta Radar knows an app's website, its
name is underlined — click it to open the developer's page and check for
an Apple Silicon or Universal update.

Click any column heading to sort by it (click again to reverse). Your
filter stays applied while you sort, so you can type a maker's name (for
example "ON1"), then sort those apps by Last Opened and deal with them
together. Clicking an app's location copies that folder's path so you can
jump to it in Finder (press Cmd-Shift-G, paste, Return).


PREFER NOT TO USE THE APP?
--------------------------
There is also a file called  "Rosetta Radar.command".  Double-click
it to run exactly the same scan in a Terminal window instead. It follows
the same first-time confirmation steps described above.


YOUR PRIVACY
------------
Rosetta Radar runs fully offline by default — it makes no network
connections and sends nothing anywhere. At launch it offers an OPTIONAL
online lookup (off by default): if you choose it, only the NAMES of apps
it does not already recognize are sent to Apple's App Store search and
Wikipedia, to fill in a description and, where possible, a website link
so you can check for an Apple Silicon or Universal update. Those results
are cached on your Mac. Nothing else ever leaves your computer, and the
reports stay on your Desktop until you delete them.

TIP: Run it once offline first. If the report shows many apps with no
description or link, run Rosetta Radar again and choose "Look up online"
to fill in the gaps.

CREDITS
-------
Rosetta Radar includes a built-in library of descriptions and website
links for roughly 6,000 Mac apps, sourced from the Homebrew Cask project
(https://brew.sh, BSD-2-Clause license). Everything works offline; the
online lookup is only for apps not covered by that library. The full
license notice is in the included file "Third-Party Notices.txt".


==========================================================================
  FOR THE DISTRIBUTOR  (notes for Ast-Ware Arts)
==========================================================================

HOW IT WORKS
   • "Rosetta Radar.app" is a small bundle whose executable is a
     shell script (Contents/MacOS/RosettaRadar). It uses
     `system_profiler SPApplicationsDataType -json` to enumerate every
     installed app, then determines each app's architecture by inspecting
     its actual program file with the built-in `file` tool
     (x86_64 = Intel, arm64 = Apple Silicon, both = Universal). The list
     and reports are assembled with JXA (JavaScript for Automation).
     Everything used is built into macOS, so there are no dependencies
     (no Python, jq, Homebrew, etc.).
   • The .command file is that same script, standalone.

REBRANDING
   Edit the two lines near the top of the script:
       BRAND="Ast-Ware Arts"
       CONTACT="Ast-WareArts@protonmail.com"
   In the app, the script is at:
       Rosetta Radar.app/Contents/MacOS/RosettaRadar
   (Right-click the app > Show Package Contents to get inside.)
   These appear in the report's footer. To change the app icon, replace
   Contents/Resources/AppIcon.icns.

REMOVING THE FIRST-RUN WARNING (optional)
   The right-click-Open step exists because the app is unsigned. To let
   recipients open it with a plain double-click and no warning, sign and
   notarize it with your Apple Developer ID ($99/yr) before distributing.
   The "Notarize this app.command" helper (provided separately to you, the
   distributor, and NOT part of this package) walks through signing,
   submitting to Apple, and stapling. Without notarization, the
   right-click > Open instructions above are the normal way for recipients
   to launch a free, unsigned utility.

   Tech-savvy recipients can also clear the quarantine flag themselves:
       xattr -dr com.apple.quarantine "/path/to/Rosetta Radar.app"

APP COVERAGE
   The scan is comprehensive: it merges the apps macOS reports
   (system_profiler) with the app bundles Spotlight has indexed, de-duplicated,
   so nested helpers and apps in ~/Applications or odd locations are included.
   At launch it also offers to scan external / mounted volumes. (Spotlight
   indexing and the external-volume search depth are not guaranteed to reach
   every last bundle, so this is a thorough scan rather than an absolute
   guarantee of completeness.)

WHY BINARY INSPECTION
   Earlier the tool trusted the architecture label that system_profiler
   reports, but those label values vary between macOS releases and were
   misread on macOS 27. Reading each app's real program file with `file`
   is authoritative and version-proof, so results are accurate regardless
   of macOS version.

==========================================================================
